The required syntax
A configuration file is a simple text file.
Follow these rules when editing a config file:
- Blank lines are ignored.
Lines starting with ``
%'' are also ignored and can be used to include comments.
This is also true for lines starting with ``@'', but in this case the rest
of the line is displayed in the application's main window.
- All other lines are parameters of the form ``keyword = value''.
Keywords are case insensitive.
Spaces or tabs around a keyword are ignored.
The same keyword can appear more than once in a config file;
later values override earlier ones.
- The ``
='' character is optional, but I recommend you put it in.
Any spaces or tabs around ``='' are ignored.
The parameter value consists of one or more strings.
Multiple strings are separated by spaces or tabs, so use double quotes
around a string that includes spaces.
If only one string is required then the rest of the line is ignored.
- To avoid very long lines, use ``
|'' to split lines anywhere you like.
Upon reading a ``|'', the application will ignore the rest
of the current line and continue reading from the next line.
The best place to use ``|''
is where a space is allowed; that way you can safely indent the next line
to make the file more readable.
- A line starting with ``
!'' tells the application to stop reading
the config file.
This lets you add comments without having to start each line with ``%''.
Note that the syntax is the same for all Oz... applications,
but each one uses a different set of keywords.